Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Undo for Movies

UseMovieEditState

Your application can use the UseMovieEditState function to return a movie to its condition according to an edit state you created previously.

pascal OSErr UseMovieEditState (Movie theMovie, 
                                 MovieEditState toState); 

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

toState

Specifies the edit state for this operation. Your application obtains this edit state identifier when you create the edit state by calling the NewMovieEditState function (described in the previous section).

DESCRIPTION

The UseMovieEditState function uses the information stored in the edit state to update the movie's contents. This may change the contents of some of the movie's tracks, or it may even add tracks to the movie or remove tracks from the movie. Consequently, the movie's time and spatial characteristics, especially the duration, may change as a result of restoring the saved edit state. Your application creates an edit state by calling the NewMovieEditState function, which is described in the previous section.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidEditState	-2023	This edit state is invalid
nonMatchingEditState	-2024	This edit state is not valid for this movie
staleEditState	-2025	Movie or track has been disposed